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DYNAMIC DATA BUFFER ALLOCATION TUNING 



FIELD OF THE INVENTION 

The present invention relates generally to data management, and more 
specifically, to dynamically tuning the allocation data buffers. 

BACKGROUND OF THE INVENTION 

The development of the Litemet, and in particular the development of the World 
Wide Web ("WWW'), has created a mechanism whereby a tremendous amount of 
information has been made publicly available to anyone who has access to a client 
computer. For example, by interacting with a chent computer, a user can connect to 
thousands, if not millions of different web sites to access and/or retrieve information that 
is contained within an electronic document or web page. 

To provide access to their web site, many businesses contract with an Internet 
Service Provider ("ISP") to host the company's web site. For many companies, there is a 
strong desire to obtain statistical information regarding the traffic or "hits" on the 
company's web site. Thus, as part of hosting a company's web site, an ISP will typically 
collect a variety of statistical information about each of the hosted web sites. For 
example, an ISP may collect statistical information such as, the number of access 
requests ("hits") that are received for a particular site, the volume of hits that are received 
by a web site during any particular time of day, the frequency that a certain page or 
image is accessed within the web site, along with other statistical information that may 
be deemed important for a particular web site. 
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Traditionally, an ISP will typically assign a single web site domain to each web 
server. By assigning a single web site domain to each web server, the ISP can easily 
monitor and log statistical information about the activity that is associated with the web 
site domain. For example, FIG. lA illustrates a system 100 in which a web server 
(SrrE_A.COM WEB SERVER 102) has been configured to host a single web site 
domain ("SrrE_A.COM"). In this example, multiple server threads (SrrE_A server 
threads 110, 112, 114, 1 16), executing in a memory address space 108, service requests 
for access to the single web site domain SrrE_A.COM. In addition, in order to monitor 
the activity that is associated with the SrrE_A.COM domain, as part of servicing the 
requests from client devices (130, 132, 134, 136), SirE_A server threads 1 10, 1 12, 114, 
116, repeatedly write SrrE_A access information into buffers 120, 122, 124, 126. 
Thereafter, because each of the buffers 120, 122, 124, 126, are guaranteed to only 
contain access information for the single web site domain (SrrE_A.COM), if any of the 
buffers 120, 122, 124, 126 become full, the contents of the buffer may be stored to a 
single file (for example, siteA.com log file 106 on physical disk 104), without having to 
determine which web site domain was associated with the request. Thereafter, statistical 
information may be later generated for SrrE_A.COM domain based on the access 
information that was stored to physical disk 104. 

However, while tiie practice of assigning a single web site domain to a web server 
can significantiy reduce the complexity of generating and logging statistical access 
information for a particular web site domain, the practice also inti-oduces a significant 
scalabihty problem. For example, using tiie described configuration, for an ISP to be 
able to host a hundred different web site domains, the ISP would need to purchase and 
maintain a hundred different web servers. For most ISPs, maintaining a one-to-one 
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relationship between the number of web servers and the number of web site domains that 
the ISP can support is both inefficient and financially impracticable. 

hi an attempt to address the scalability problem, some web servers have been 
configured to include multiple server threads that execute within separate processes 
within their own individual memory space. By executing multiple server threads as 
separate processes within their own individual memory space, certain complexities that 
are typically associated with generating and logging statistical access information for 
multiple web site domains may potentially be reduced. 

For example, FIG. IB illustrates a system 150 that includes a web server 152 that 
consists of multiple server threads (160, 162, 164, 166) each of which execute in a 
separate memory space 158a-d, respectively. In addition, server threads 160, 162, 164, 
164, are respectively associated with buffers 170, 172, 174 and 176, which are each used 
to buffer access information for a distinct web site domain (SITE_A.COM, 
SrrE_B.COM, SrrE_C.COM, SrrE_D.COM), and to store the information to disk 154 
within a corresponding log file 156a-d. By servicing multiple web sites in a single web 
server, certain inefficiencies that are associated with the system 100 depicted in FIG. 1 A 
can be reduced. In addition, because each server thread (160, 162, 164, 166) executes in 
a separate memory address space and services access requests for only a single web site 
domain, the problem of ensuring that log data for one site is not incorrectly stored in the 
physical log file of another can generally be reduced. 

However, a significant drawback with the configuration of system 150 is that by 
requiring specific processes to be used to service specific web site domains, a scalability 
problem is again introduced in the system. For example, if SrrE_A and STTE.B receive 
heavy traffic while SriE.C and SrrE_D typically receive Uttle or no traffic, up to fifty 

-4- 

15437-0539 (P6356) 



percent (50%) of system 150 resources (e.g., server threads, buffers, etc.) may sit idle 
and thus be wasted. Jn addition, system 150 requires that each web site domain be 
associated with its own process, which in the case of multiple web site domains can 
cause the system resources to quickly become depleted. Still further, the overhead that 
associated with swapping between the different memory address spaces for each of the 
server threads can itself be a significant drain on the system resources. 

Based on the foregoing, there is a clear need for an improved mechanism that 
allows multiple web site domains to be efficiently serviced by a single web server. 
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SUMMARY OF THE INVENTION 

A method and apparatus are provided for dynamically allocating data buffers to a 
buffer array. According to one aspect of the invention, the amount of log data that is 
being stored within data buffers associated with a buffer array is monitored. Based on 
the amount of log data that is being stored widiin the data buffers, a determination is 
made as to whether additional data buffers need to be linked into the buffer array. If it is 
determined that additional data buffers do need to be linked to die buffer array, one or 
more free buffers are identified and linked into the buffer array. 

According to another aspect, dynamic allocation of data buffers in a web server is 
provided. In this aspect, a web server in configured to service requests for multiple web 
site domains. A buffer file, that is assigned to a particular web site domain within tiie 
multiple web site domains, includes a buffer array that maintains links to data buffers 
that are used to buffer log data. The buffer log data is based on content requests that are 
directed to the particular web site domain. Allocation of data buffers to the buffer array 
is dynamically controlled based on the number of content requests tiiat are received by 
the web server for content that is associated with the particular web site domain. 

The invention also encompasses a computer-readable medium, a computer data 
signal embodied in a carrier wave, and an apparatus configured to carry out the foregoing 
steps. Other features and aspects will become apparent from the following description 
and the appended claims. 



15437-0539 (P6356) 



-6- 



4 



BRIEF DESCRIPTION OF THE DRAWINGS 

The present invention is illustrated by way of example, and not by way of 
limitation, in the figures of the accompanying drawings and in which like reference 
numerals refer to similar elements and in which: 

FIG. 1 A depicts a conventional system in which a web server is configured to 
host a single web site domain; 

FIG. IB depicts another conventional system in which a web server is configured 
to service multiple web site domains by executing separate threads, each within its own 
memory space; 

FIG. 2A illustrates an example of a data buffering system in which certain 
embodiments of the invention may be utilized; 

FIG, 2B is a flow diagram that illustrates an example of a method for processing 
requests for content that is associated with different web site domains; 

FIG. 3 A is a block diagram of a buffer file that depicts certain internal details 

thereof. 

FIG. 3B is a flow diagram that illustrates an example of a method of selecting a 
data buffer within a buffer file for writing log data; 

FIG. 3C is a flow diagram that further illustrates an example of a method of 
selecting a data buffer within a buffer file for writing log data; 

FIG. 4A is a block diagram that further illustrates certain internal details that may 
be included in the web server described in FIG. 2A; 

FIG. 4B is a flow diagram that illustrates an example of a method for identifying 
a log file in secondary memory and for writing the log data into the identified log file in 
secondary memory; and 

FIG. 5 is a block diagram of a computer system with which an embodiment may 
be carried out. 
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DETAE^D DESCRIPTION OF THE INVENTION 

An efficient buffering mechanism is provided for buffering infomation that is 
associated with requests for electronic content, hi the following description, for the 
purposes of explanation, numerous specific details are set forth in order to provide a 
thorough understanding of the present invention. It will be apparent, however, to one 
skilled in the art that the present invention may be practiced without these specific 
details, hi other instances, well-known structures and devices are shown in block 
diagram form in order to avoid unnecessarily obscuring the present invention. 

OPERATIONAL CONTEXT 
A tuning mechanism that dynamicaUy allocates data buffers is provided. In one 
embodiment, a web server is configured to service requests for content that is located in 
different web site domains. To service the requests, the web server employs a connection 
queue that receives requests, fi-om multiple clients over a network, for access to content 
located in multiple web site domains. Upon receipt, the requests are queued within a 
connection queue for service by one of a plurality of server tiireads. The server tiireads 
are configured as virtual servers that allow them to service requests for different web site 
domains by removing the requests from the connection queue and loading the 
configuration data that is associated with the specific web site domain. As part of 
servicing a request, each server thread generates log data based on the content that is 
being requested by the particular client. The server thread then interfaces with a log 
manager to identify a buffer file that is configured for buffering log data that is 
associated witii tiie specific web site domain. To buffer the log data, an efficient 
buffering scheme is used to select a buffer within the buffer file and to write the log data 
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into the selected buffer. Thereafter, the log data is written into a log file in secondary 
memory that is associated with the specific web site domain. 



SYSTEM OVERVIEW 

FIG. 2A illustrates an example of a data buffering system 200 in which certain 
embodiments of the invention may be used. In this example, system 200 includes a 
pluraHty of client devices (232, 234, 236, 238), a network 248, a web server 202 and a 
secondary memory, illustrated herein as disk 230. 

Network 248 may represent a private and/or public network, such as the Internet, 
and comprised of a one or more LANs and/or WANs that are configured for 
communicating between multiple computing devices. In addition, network 248 may be 
formed using a variety of different communication mediums, including but not limited to 
electrical wire or cable, optical, or wireless connection mediums. In one embodiment, 
network 248 is configured as a packet-switched network that can support such protocols 
as the HyperText Transport Protocol (HTTP) or the Wireless Access Protocol (WAP). 

Client devices 232-238 represent computing devices that are capable of 
requesting information or content that is available on one or more web sites. For 
example, client devices 232-238 may represent a personal computer (PC), a workstation, 
a cellular phone, a PDA, or other device that is capable of communicating with web 
server 202 over network 248. In certain embodiments, client devices 232-238 are 
configured to execute a browser type application, such as Netscape Navigator®, or other 
similar type of WAP or HTML browser application. 

Web Server 202 is a computer, or a group of hardware and/or software 
components or processes that cooperate or execute in one or more computer systems. In 
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one embodiment, web server 202 is configured to service requests for multiple web site 
domains. For example, web server 202 may be configured to service requests for content 
that is associated with the web site domains SITE_A.COM, SrrE_B.COM, 
SrrE_C.COM, and SrrE_D.COM. 

As depicted, web server 202 includes a connection queue 208, a plurality of 
server threads (210,212,214,216) that execute as virtual servers 204, and a pluraUty of 
buffer files (218,220,224,226) that form part of a log manager mechanism 206. In one 
embodiment, connection queue 208, server threads (210,212,214,216), and buffer files 
(218,220,224,226) execute within a single memory address space 228. 

hi this example, connection queue 208 is configured to receive client requests for 
access to content that is located on web site domains that are serviced by web server 202. 
Upon receiving a request, connection queue 208 queues the request for service by one of 
the virtual servers 204. Thereafter, an available server thread ("servicing thread") 
"picks-up" the queued request and determines the location of the content that is being 
requested by the client device. Based on the location of the content that has been 
requested by the client device, the servicing thread loads configuration data for a 
particular web site domain and generates a set of log data that provides information 
about the requested content. The servicing thread then identifies, firom among the 
plurality of buffer files (218,220,224,226), a buffer file that has been assigned to buffer 
log data for the particular web site domain. A buffer within the identified buffer file is 
then selected for writing the set of log data. As is explain in greater detail below, log 
manager 206 employs an efficient data buffering scheme for managing the number of 
available buffers within a buffer file and for selecting the particular buffer that is to be 
used for storing the set of log file. 
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Subsequent to writing the log data into a particular buffer within a buffer file, the 
log data is stored within a log file that is maintained on disk 230. Disk 230 represents a 
secondary storage and/or memory that is distinct from the memory that is used for 
buffering the log data. In one embodiment, disk 230 represents a nonvolatile storage 
device that is accessible by web server 202 for storing log data associated with different 
web site domains. For example, disk 230 may represent a variety of different secondary 
storage devices and/or units including, but is not limited to, internal or external disk 
drives, vwiteable CD or DVD storage units, or floppy disk or magnetic tape drive units. 
In addition, although disk 230 is depicted as being separate from web server 202, disk 
230 may also be configured as part of web server 202. 

In one embodiment, disk 230 maintains a plurality of log files (240,242,244,246) 
that are used to store log data that is associated with a particular web site domain. For 
example, SrrE_A.COM log file 240 is used to store log data that is associated with 
requests for content that is located on the web site domain SrrE_A.COM. 

PROCESSING CONTENT REQUESTS 

FIG. 2B is a flow diagram that illustrates an example of a method for processing 
requests for content that is associated with different web site domains. For explanation 
purposes, FIG. 2B is described in reference to the components of FIG. 2A. 

At block 252, a request is received for access to content that is associated with a 
particular web site domain. For explanation purposes, it is assumed that the received 
request is from client 232, that the request is for access to content that is associated with 
the web site domain "SrrE_A.COM," and that the request has been queued within 
connection queue 208. 
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At block 254, a server thread is assigned and/or scheduled to service the request. 
For example, although any available server thread (210,212,214,216) may be assigned to 
service the request, for this example it is assumed that server thread 214 has been 
assigned the task of servicing the particular request (i.e., designated as the servicing 
thread). 

At block 256, the servicing thread loads the appropriate configuration data for the 
web site domain that is associated with the request. For example, upon detecting that the 
request is associated with the web site domain SITE_A.COM, server thread 214 loads 
the corresponding configuration data for the web site domain SrrE_A.COM. In one 
embodiment, by loading the SrrE_A.COM configuration data, server thread 214 is 
temporarily configured as a server thread dedicated to servicing requests for content that 
is available within the SrrE_A.COM domain. 

At block 258, log data is generated based on the content that was requested by 
client 232. For example, the generated log data may include, among other things, 
information that identifies a particular web page that was requested within the 
SrrE_A.COM domain. 

At block 260, a buffer file that is associated with the SrrE_A.COM domain is 
identified. In this example, SrrE_A buffer file 218 is identified by server thread 214 as 
containing buffers that are to be used for buffering log data that is associated with the 
SrrE_A.COM domain. 

At block 262, which is described in further detail below with respect to FTGs. 3 A- 
3C, an efficient buffering scheme is used to select a particular buffer within the 
identified buffer file (block 264) and to write the log data into the selected data buffer 
(block 266). 
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At block 268, which is described in further detail below with respect to FIG. 3 A 
and FIGs. 4A-4B, a physical log file that is associated with the buffer file is subsequently 
identified (block 270) and the information contained within the selected data buffer is 
stored into the identified physical file (block 272). For this example, the SITE_A.com 
log file 240 on disk 230 is identified as the appropriate physical log file and thus used as 
the physical log file for storing the log data contain within the data buffer of SrrE_A 
buffer file 218. 

SELECTING A BUFFER FOR BUFFERING LOG DATA 

FIG. 3 A is a block diagram of SITE_A buffer file 218 showing certain internal 
details thereof. As depicted in the example of FIG. 3 A, SITE_A buffer file 218 includes 
a name identifier 302, a file descriptor (FD) 304, a last buffer index 306, a buffer array 
308 and a ready-to-write buffer list 310. 

Name identifier 302 identifies the domain site that has been assigned to the 
particular buffer file. In this example, name identifier 302 indicates that buffer file 21 8 
has been assigned to buffer log data for the web site domain SrrE_A.COM. 

File descriptor 304 identifies the physical log file that is to be used to store the 
buffered log data. In this example, file descriptor 304 identifies the SrrE_A.com log file 
240 on disk 230 as the physical log file that has been designated to the buffered log data 
that is associated with SrrE_A buffer file 218. 

Buffer array 308 includes an array of buffers (312,314,316,318,320) that can be 
used for storing log data. For explanation purposes, a set of array index values 330 is 
used to help identify the different indices within buffer array 308. In one embodiment, 
each index is associated with either zero or one buffer, which may or may not be 
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available for buffering log data. For example, the entry in buffer array 308 that is 
associated with index "5" is currently linked to buffer 318. Alternatively, the entry in 
buffer array 308 that is associated with index "4" is not currently linked to any buffer. 

A variety of techniques and/or algorithms may be used to determine the size of 
buffer array 308. For example, the number of array entries in buffer array 308 may be 
dependent on, including possibly a combination thereof, the number of CPUs that exist 
within the system, the number of server threads that can potentially write into buffers 
that are associated with buffer array 308, the number of server threads that can be 
simultaneously active at any point in time, etc. In certain embodiments, the length of 
buffer array 308 may be dynamically adjusted to increase or decrease the number of 
buffer array entries. 

As further depicted m this example, each entry in buffer array 308 is associated 
with a flag that indicates whether a particular index in buffer array 308 is likely to 
contain a buffer that is currently available for writing log data. For example, the flag 
value of "1" of index "2" of buffer array 308 indicates that buffer 314 is not likely to be 
currendy available for storing log data ("busy"), while the flag value of "0" of index "3" 
of buffer array 308 indicates that buffer 316 is likely to be currently available for storing 
log data ("not busy"). 

In one embodiment, last buffer index 306 identifies the index associated with the 
last buffer that was selected to store log data. For example, the current value ("2") of last 
buffer index 306 indicates that the buffer associated with index "2" in buffer array 308 
(buffer 3 14) was last selected to log data. Alternatively, last buffer index 306 may be 
used to identify the index that was first tried last time a thread attempted to write into a 
buffer with the buffer array. For example, if the last buffer index 306 currently has a 
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value of "2", when a thread first attempts to write a particular set of data into a buffer in 
buffer array 308, the value of last buffer index 306 is incremented to equal "3". The 
thread then determines whether there is a buffer associated with index "3" that is 
available for writing data. If the thread determines that mdex "3" is not associated with 
an available buffer, then the thread next determines whether there is a buffer associated 
with mdex "4" that is available for writing data. However, in this case, last buffer index 
306 is not incremented to the value "4" but instead retains the value of the index that was 
first used in attempting to write the particular set of data to a buffer. 

Finally, ready-to-write buffer list 310 represents a list of buffers that have been 
removed from buffer array 308 and which contain log data that is ready to be written out 
to disk. An example is provided below that describes how the components of SITE_A 
buffer file 218 may be used to provide an efficient data buffering scheme. 

Although this example illustrates the use of a buffer array 308, this is done 
merely for illustrative purposes as a variety of different data stracmres may be used for 
implementing the desired functions. For example, the buffers associated with a buffer 
file could be placed in a list instead of an array with the list position being used to index 
the most-recently accessed buffer within the list. Additionally, buffer file 218 is used as 
merely an example of a type of buffer management structure that may be used to 
implement the described functions. Thus, embodiments of the invention are not limited 
to any particular type of buffer management structure. 

SELECTING A DATA BUFFER FOR WRITING LOG DATA 
FIG. 3B and Fig. 3C is a flow diagram that illustrates an example of a method for 
selecting a data buffer within a buffer file for writing log data (see block 262 of FIG. 
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2B). For explanation purposes, HG. 3B and FIG. 3C are described in reference to the 
components of HG. 3 A. Further to this example, it is assumed that SnE_A buffer file 
21 8 was identified as the buffer file for selecting the particular data buffer that is to be 
used to store the log data. 

At block 352, the "initial" value of the last buffer index variable is read from the 
buffer file. As used herein, the "initial" value represents the value of the last buffer 
index at the time a server thread initiates the process of selecting a buffer for the 
particular set of log data. In addition, as used herein, the "incremented initial" value is 
equal to the initial value after it has been incremented once during the particular 
selection process. For this example, die "initial" value for the last buffer index 306 is 
equal to "2" and the "incremented initial" value for the last buffer index 306 is equal to 
"3". 

At block 354 the last buffer index value is incremented to point to the next index 
within the buffer array. For example, the value of last buffer index 306 is incremented so 
as to equal the value "3". By incrementing the last buffer index value to point to a next 
index within die buffer file, a mechanism is provided that can increase the chance that 
die buffer associated with the current index value is likely available for storing log data. 
In certain embodiments, die MOD function may be used to cause die incrementing of the 
last buffer index 306 to have a value tiiat wraps around die length of die buffer array 308. 
For example, if die last buffer index 306 has a value of "6," incrementing the last buffer 
index 306 will cause die last buffer index 306 to have a value of "0". 

At block 356, a test is made to determine whedier die flag for die buffer array 
entry that is associated witii the current value of the last buffer index value is set to busy. 
For example, the flag for the buffer array entry diat is associated with the current value of 
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the last buffer index value ("3") is tested to determine if it is set to busy. If it is 
determined that the flag is not set to busy (for example, the flag equals "0"), control 
proceeds to block 357. 

Alternatively, if at block 356 it is determined that the flag is set to busy, at block 
358 a test is made to determine whether all of the buffer entries in the buffer array have 
been checked for locating an available data buffer. If it is determined that the buffer 
array includes additional entries that have not yet been checked, control proceeds to 
block 354 to again increment the last buffer index value. Conversely, if it is determined 
that the buffer array does not include any additional entries that have not yet been 
checked, at block 360, the buffer array entry that is associated with the incremented 
initial value of the last buffer index value is selected as the "selected" buffer array entry. 
Control then proceeds to block 362. For example, if it is determined that no entry in 
buffer array 308 is associated with a flag that is not set to busy, the buffer array entry 
that is associated with the incremented initial value ("3") is selected and control then 
proceeds to block 362. 

At block 357, the buffer array entry that is associated with the current value of 
the last buffer index variable is selected as the "selected" buffer array entry. For 
explanation purposes, it shaU be assumed that in this example, last buffer index 306 has 
a current value equal to "3" and that the buffer array entry associated with the array 
index of "3" has been selected as the selected buffer array entry. 

At block 362, a test is made to determine whether the selected buffer array entry 
is currently linked to a buffer. As is explained in further detail below, buffers that 
contain log data that is to be written to disk may be removed from the buffer array 308 
and inserted into the ready-to-write buffer list 3 10. In this example, the buffer array 
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entry that is associated with the array index value "3" is currently linked to buffer 316. 
On the other hand, the buffer array entry that is associated with the array index value "4" 
is not currently linked to any buffer. 

If at block 362 it is determined that the selected buffer array entry is currently 
linked to a buffer, then the buffer is selected as the "selected" buffer and control 
proceeds to block 366. Conversely, if it is determined that the selected buffer array entry 
is not currently Unked to a buffer, then at block 364 a buffer is retrieved from a free 
buffer pool (for example, free buffer pool 408 in FIG. 4A) and linked into the buffer 
array entry, thus becoming the "selected" buffer. Jn this example, because the selected 
buffer array entry (entry "3") is currently linked to buffer 316, buffer 316 is selected as 
the selected buffer within buffer array 308. 

At block 366, an attempt is made to obtain a mutually exclusive lock on the 
selected buffer. 

At block 368, it is determined whether the selected buffer is currently locked by 
another server thread. For example, if the attempt to obtain the mutually exclusive lock 
on the selected buffer fails, the selected buffer is likely to be locked by another server 
thread that is attempting to write its log data into the same selected buffer. If at block 
368 it is determined that the buffer is not currently locked by another server thread, 
control proceeds to block 372 in HG. 3C. 

Alternatively, if at block 368 it is determined that the buffer is currently locked 
by another server thread, then at block 370 a wait process is initiated to wait for the 
current lock on the buffer to be released. Thereafter, controls proceeds to block 372. 

At block 372, the flag associated with the selected buffer array entry is set to 
busy. For example, the flag associated with the selected buffer array entry is set equal to 
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"1" in order to inform other server threads that the buffer associated with the selected 
buffer array entry (buffer 316) is currently not available for storing log data. 

At block 374, the selected data buffer is locked for writing log data into the data 
buffer. For example, a mutually exclusive lock is executed on buffer 316. 

At block 376, the log data is written into the selected buffer. For example, the log 
data generated by server thread 214 is vmtten into buffer 316 in SITE.A buffer file 218. 

At block 378, a check is made to determine whether the selected buffer should be 
removed from the buffer array. For example, in one embodiment, the determination of 
whether the selected buffer should be removed from the buffer array is made based on 
the amount of free space that is left within the selected buffer. In another embodiment, 
the determination of whether the selected buffer should be removed from the buffer array 
may be based on the amount of time that the selected buffer has remained linked within 
the buffer array 308. 

If at block 378 it is determined that the selected buffer should be removed from 
the buffer array, the selected data buffer is moved to the ready-to-write buffer list (block 
380) and the lock on the selected data buffer is released (block 382). Alternatively, if at 
block 378 it is determined that the selected buffer should not be removed from the buffer 
array, the lock on the selected data buffer is released (block 384) and the flag associated 
with the selected buffer array entry is cleared (block 386). 

For example, if it is determined that selected data buffer 316 should be removed 
from the buffer array 308, selected data buffer 316 is moved to the ready-to-write buffer 
list 310 and the mutually exclusive lock on selected data buffer 316 is released. 
Alternatively, if at block 378 it is determined that selected buffer 316 should not be 
removed from the buffer array 308, the mutually exclusive lock on selected data buffer 
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316 is released and the flag associated with the selected buffer array entry (buffer array 
entry for array index "3") is set equal to "0'\ 

Although this example, as with certain other examples within the specification, 
illustrate a specific sequence of steps for performing a particular process and/or function. 
However, unless specifically stated in the disclosure, embodiments of the invention are 
not limited to any particular order of carrying out such steps. For example, the step of 
setting the flag associated with the selected buffer array entry to busy (block 372), may 
in certain embodiments, be performed just prior to determining whether the selected 
buffer array entry is currently linked to a buffer (block 362). Thus, the examples 
described herein are used for illustrative and/or explanation purposes only and should not 
be viewed in anyway as limiting the scope of embodiments of the invention. 

GLOBAL AND LOCAL LOGGING THREADS 
In certain embodiments, a group of one or more logging threads are used to write 
log data to a secondary storage. As described in further detail below, the logging threads 
provide a tuning mechanism for dynamically adjusting the number of buffers that are 
associated with each buffer file (218,220,224,226). In certain embodiments, by 
dynamically tuning the number of buffers that are associated with each buffer file, an 
efficient buffering system is provided that can dynamically adjust the available resources 
based on the bandwidth needs of web site domains that are being serviced by the web 
server. 

For example, FIG. 4A is a block diagram that further illustrates certain internal 
details that may be included in web server 202 as previously described in FIG. 2A. As 
depicted in the example, web server 202 includes a group of one or more logging threads 
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(local logging threads 402, 404 and global logging thread 406) that are used to write log 
data from data buffers in log manager 206 to logs files (240,242,244,246) in disk 230. 
In addition, in certain embodiments, the logging threads (local logging threads 402, 404 
and global logging thread 406) are responsible for either re-linking emptied data buffers 
into the buffer array of their assigned buffer file, or for inserting emptied data buffers 
into the firee buffer pool 408. 

In one embodiment, logging threads (402,404,406) are responsible for actively 
monitoring the number of requests that are directed to web site domains that are being 
serviced by the web server ("domain traffic"). Based on the domain traffic for a 
particular web site domain, the logging threads (402,404,406) can dynamically adjust the 
number of data buffers that are associated with the buffer file for that particular web site 
domain. For example, by monitoring the number of buffers that are moved into the 
buffer full list 310, local logging thread 402 can determine the throughput demands that 
are currently required for the web site domain SrrE_A.COM. Based on the throughput 
demands, local logging thread 402 can dynamically adjust the certain variables that can 
affect the number of resources that are available for servicing requests that are directed to 
the web site domain SrrE_A.COM. For example, based on the throughput demands for 
web site domain SrrE_A.COM, local logging thread 402 can dynamically adjust the 
resources (bandwidth) that is allocated to SrrE_A.COM by tuning such factors as: (1) 
tiie number of entries in buffer array 308; (2) the minimum or maximum number of data 
buffers that are to be consistently linked to buffer array 308; (3) whether a buffer is to be 
re-Unked into buffer array after its contents are written to secondary memory; along with 
other factors that may influence the resources that are allocated to SrrE_A.COM. 
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In certain embodiments, web site domains that are experiencing a large amount of 
traffic may be assigned a local logging thread to reduce the contention that can exist in a 
global logging thread that is configured to service multiple web site domains. For 
example, as depicted in FIG. 4A, local logging threads 402 and 404 have respectively 
been assigned to service SrrE_A buffer file 21 8 (web site domain SITE_A.COM) and 
SrrE_D buffer file 226 (web site domain SITE_D.COM). Alternatively, global logging 
thread 406 is assigned to service both SirE_B buffer file 220 (web site domain 
SITE_B.COM) and SrrE_C buffer file 224 (web site domain SrTE_C.COM). Thus, 
resources associated with the SITE_B.COM and SITE_C.COM domains will be required 
to compete with each other for certain data logging resources. 



MOVING BUFFER TO A READY-TO-WRTTE BUFFER LIST 

As previously described, buffers that contain log data that are ready to be written 
to secondary storage ("ripe buffers") are removed firom their associated buffer array and 
inserted into a ready-to-write buffer list within the buffer log file. In one embodiment, 
die logging thread that has been assigned to the particular buffer file is configured to 
identify and remove ripe buffers from the buffer array and to insert the buffers into the 
ready-to-write buffer list for subsequent storing to secondary memory. 

A variety of methods and/or techniques may be used for identifying ripe buffers. 
For example, a buffer that is completely full, or a buffer that has only a limited amount of 
free space, (for example a certain number of free blocks or bytes, or a certain percentage 
of total free space), may be identified as a ripe buffer and thus removed and inserted into 
a ready-to-vwite buffer list. 
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Additionally, in certain embodiments, buffers that are considered "stale" (i.e., 
buffers that contain data but that have not been removed from the buffer array for a 
particular amount of time), may be marked as ripe buffers and thus removed and inserted 
into the ready-to-write buffer list. For example, logging thread 402 may be configured to 
periodically identify and remove buffers that contain log data and that have remained 
attached to the buffer array 308 for a particular period of time. Altematively, or in 
addition to, logging thread 402 may be configured to reduce the amount of time that log 
data remains within a buffer by removing and inserting into the ready-to-write buffer list 
310 all buffers that contain log data as of a particular time of day (for example, 2:00am). 

SEQUENCE FOR STORING LOG DATA TO SECONDARY MEMORY 
FIG. 4B is a flow diagram 450 that illustrates an example of a method for 
identifying a log file in secondary memory and for vmting the log data into the identified 
log file in secondary memory (see block 268 of HG. 2B). For explanation purposes, FIG. 
4B is described in reference to the components of FIGs. 2A, 3 A and 4A. 

At block 452, a logging thread determines that the contents of a data buffer that is 
associated with a buffer file should be written to secondary memory. For example, for 
explanation purposes it shall be assumed that local loggmg thread 402 determines that 
buffer 322 in ready-to-write buffer Hst 310 of SITE_A buffer file 218 should be written 
out to disk 230. 

At block 454, the log file in secondary memory that is associated with the buffer 
file is identified. For example, based on the value of file descriptor 304 (SITE_A.COM 
LOG FILE) in SITE_A buffer file 218, local logging thread 402 determines that 
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SrrE_A.com log file 240 on disk 230 is assigned to store log data that is associated with 
SriE.A buffer file 218. 

At block 456, the logging thread obtains a lock on the data buffer within the 
ready-to-write buffer list of the buffer file. For example, a local logging thread 402 
obtains a mutually exclusive lock on buffer 322 in ready-to-write buffer list 310 of 
SrrE_A buffer file 218. 

At block 458, the logging thread writes the contents of the locked data buffer into 
the previously identified log file in secondary memory. For example, local logging 
thread 402 writes the log data that is contained in buffer 322 into SITE_A.com log file 
240 on disk 230. 

At block 460, a decision is made as to whether the data buffer should be inserted 
back into the buffer array within the buffer file. For example, after logging the data to 
secondary storage, local logging thread 402 determines whether or not buffer 322 should 
be re-inserted back into buffer array 308. As previously indicated, a variety of factors, 
which may include the amount of traffic that is currently being received for the particular 
web site domain (SITE_A.COM), can be used in determining whether a buffer should be 
inserted back into the buffer array. If at block 460 it is determined that the buffer should 
be inserted back into the buffer array, control proceeds to block 464. 

Alternatively, if at block 460 it is determined that the buffer should not be 
inserted back into the buffer array, at block 462 the buffer is added into the free buffer 
pool. Control then proceeds to block 470. For example, if local logging thread 402 
determines that buffer 322 should not be inserted back into buffer array 308, local 
logging thread 402 causes buffer 322 to be placed into free buffer pool 408. 
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At block 464, an entry in the buffer array is identified for inserting the data 
buffer. For explanation purposes, it is assumed that the entry within buffer array 308 
that is associated with an array index of "1" is selected for re-inserting buffer 322. 

At block 466, the data buffer is inserted back into the buffer array. For example, 
5 buffer 332 is linked back into the entry associated with an array index of "1" in buffer 
array 308. 

At block 468, the flag associated with the entry in which the data buffer was re- 
inserted in the buffer array is cleared to indicate that the entry is likely available for 
buffering log data. For example, the flag for the entry within buffer array 308 that is 
10 associated with an array index of "1 " is set to "0" to mdicate to the server threads 

(210,212,214,216) that the entry includes a buffer (buffer 322) that is likely available for 
buffering log data. 

At block 470, it is determined whether the contents of another buffer should be 
vmtten out to secondary memory. If it is detemfiined that the contents of another buffer 
15 should be written out to secondary memory, control proceeds to block 454. In certain 
embodiments, if the next identified buffer is located within the same ready-to-write 
buffer list, control may instead proceed to block 456 to obtain a lock on the next 
identified buffer. For example, because local logging thread 402 is assigned to a single 
buffer file (SrrE_A buffer file 218), by default the log file will generally remain the same 
20 between multiple buffers unless multiple log files are used for a single web site domain. 

In addition, although the example illustrates separate locks for each buffer that is 
being written to disk, in certain embodiments, the ready-to-write buffer list is itself 
locked by the logging thread, thus potentially reducing the overhead that is associated 
widi locking and unlocking multiple buffers within a ready-to-write buffer list, 
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HARDWARE EXAMPLE 
FIG. 5 is a block diagram that illustrates a computer system 500 upon which an 
embodiment of the invention may be implemented. Computer system 500 includes a bus 
5 502 or other communication mechanism for communicating information, and a processor 
504 coupled with bus 502 for processing information. Computer system 500 also 
includes a main memory 506, such as a random access memory (RAM) or other dynamic 
storage device, coupled to bus 502 for storing information and instructions to be executed 
by processor 504. Main memory 506 also may be used for storing temporary variables or 

10 other intermediate information during execution of instructions to be executed by 

processor 504. Computer system 500 further includes a read only memory (ROM) 508 or 
other static storage device coupled to bus 502 for storing static information and 
instructions for processor 504. A storage device 510, such as a magnetic disk or optical 
disk, is provided and coupled to bus 502 for storing information and instructions, 

15 Computer system 500 may be coupled via bus 502 to a display 512, such as a 

cathode ray tube (CRT), for displaying information to a computer user. An input device 
514, including alphanumeric and other keys, is coupled to bus 502 for communicating 
information and conmiand selections to processor 504. Another type of user input device 
is cursor control 516, such as a mouse, a trackball, or cursor direction keys for 

20 communicating direction information and command selections to processor 504 and for 
controlling cursor movement on display 512. This input device typically has two degrees 
of freedom in two axes, a first axis (e.g., x) and a second axis (e.g., y), that allows the 
device to specify positions in a plane. 
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The invention is related to the use of computer system 500 for dynamically 
tuning the allocation data buffers. According to one embodiment of the invention, 
dynamically tuning of the allocation of data buffers is provided by computer system 500 
in response to processor 504 executing one or more sequences of one or more 
5 instructions contained in main memory 506. Such instructions may be read into main 
memory 506 from another computer-readable medium, such as storage device 510. 
Execution of the sequences of instructions contained in main memory 506 causes 
processor 504 to perform the process steps described herein. One or more processors in 
a multi-processing arrangement may also be employed to execute the sequences of 
10 instructions contained in main memory 506. In alternative embodiments, hard-wired 
^:jf circuitry may be used in place of or in combination with software instructions to 

ilj implement the invention. Thus, embodiments of the invention are not limited to any 

I specific combination of hardware circuitry and software. 

The term "computer-readable medium" as used herein refers to any medium that 
ill 15 participates in providing instructions to processor 504 for execution. Such a medium may 
ill take many forms, including but not limited to, non-volatile media, volatile media, and 

r IF 1^.^ 

transmission media. Non-volatile media includes, for example, optical or magnetic disks, 
such as storage device 510. Volatile media includes dynamic memory, such as main 
memory 506. Transmission media includes coaxial cables, copper wire and fiber optics, 
20 including the wires that comprise bus 502. Transmission media can also take the form of 
acoustic or hght waves, such as those generated during radio wave and infrared data 
communications. 

Conmion forms of computer-readable media include, for example, a floppy disk, 
a flexible disk, hard disk, magnetic tape, or any other magnetic medium, a CD-ROM, 
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any other optical medium, punch cards, paper tape, any other physical medium with 
pattems of holes, a RAM, a PROM, and EPROM, a FLASH-EPROM, any other 
memory chip or cartridge, a carrier wave as described hereinafter, or any other medium 
from which a computer can read, 
5 Various forms of computer readable media may be involved in carrying one or 

more sequences of one or more instructions to processor 504 for execution. For example, 
the instructions may initially be carried on a magnetic disk of a remote computer. The 
remote computer can load the instructions into its dynamic memory and send the 
instructions over a telephone line using a modem. A modem local to computer system 500 

10 can receive the data on the telephone line and use an infrared transmitter to convert the 
data to an infrared signal. An infrared detector coupled to bus 502 can receive the data 
carried in the infrared signal and place the data on bus 502. Bus 502 carries the data to 
main memory 506, from which processor 504 retrieves and executes the instructions. The 
instructions received by main memory 506 may optionally be stored on storage device 510 

1 5 either before or after execution by processor 504. 

Computer system 500 also includes a communication interface 518 coupled to 
bus 502. Communication interface 518 provides a two-way data communication 
coupling to a network link 520 that is coimected to a local network 522. For example, 
communication interface 518 may be an integrated services digital network (ISDN) card 

20 or a modem to provide a data communication connection to a corresponding type of 
telephone line. As another example, communication interface 518 may be a local area 
network (LAN) card to provide a data communication connection to a compatible LAN. 
Wireless links may also be implemented. In any such implementation, communication 
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interface 518 sends and receives electrical, electromagnetic or optical signals that carry 
digital data streams representing various types of information. 

Network link 520 typically provides data communication through one or more 
networks to other data devices. For example, network link 520 may provide a 
connection through local network 522 to a host computer 524 or to data equipment 
operated by an Intemet Service Provider (ISP) 526. ISP 526 in tum provides data 
communication services through the worldwide packet data communication network now 
commonly referred to as the "Litemet" 528. Local network 522 and Litemet 528 both 
use electrical, electromagnetic or optical signals that carry digital data streams. The 
signals through the various networks and the signals on network link 520 and through 
communication interface 518, which carry the digital data to and from computer system 
500, are exemplary forms of carrier waves transporting the information. 

Computer system 500 can send messages and receive data, including program 
code, through the network(s), network link 520 and communication interface 518. In 
the Intemet example, a server 530 might transmit a requested code for an application 
program through Intemet 528, ISP 526, local network 522 and communication interface 
518. In accordance with the invention, one such downloaded application provides for 
dynamically tuning the allocation data buffers as described herein. 

The received code may be executed by processor 504 as it is received, and/or 
stored in storage device 510, or other non-volatile storage for later execution. In this 
manner, computer system 500 may obtain application code in the form of a carrier wave. 
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ALTERNATIVES, EXTENSIONS 

In describing certain embodiments of the invention, several drawing figures have 
been used for explanation purposes. However, the invention is not limited to any 
particular context that is shown in the drawing figures, as the scope of the invention 
5 includes other contexts and applications in which the mechanisms and processes 

described herein are available to other mechanisms, methods, programs, and processes. 
Thus, the specification and drawings are, accordingly, to be regarded in an illustrative 
rather than a restrictive sense. 

For example, although embodiments of the invention have been described in 
reference to logging log data in a web server system, embodiments of the invention may 
be applied to various other forms or types of shared data sink systems where different 
threads of execution may be utilized for buffering data. For example, embodiments of 
the invention may be used for managing the buffering data in a variety of different 
systems and/or configuration such as in network connection and/or router systems, 
printer system, copier systems, fax systems, etc. Thus, embodiments of the invention 
should not be construed as limited to either log data or web server applications as the 
specification and drawings are, accordingly, to be regarded in an illustrative rather than a 
restrictive sense. 

As a further example, although KG. 2A illustrates a system executing in a single 
20 memory address space 228, embodiments of the invention may be practiced using a 
variety of different software and/or hardware configurations. For example, in certain 
embodiments, web server 202 may include multiple address spaces that each include the 
components depicted in memory address space 228. In addition, certain embodiments of 
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the invention may include the use of multiple processes, multiple processors or even 
multiple computers executing as part of web server 202. 

In addition, in this disclosure, certain process steps are set forth in a particular 
order, and alphabetic and alphanumeric labels are used to identify certain steps. Unless 
specifically stated in the disclosure, embodiments of the invention are not limited to any 
particular order of carrying out such steps. In particular, the labels are used merely for 
convenient identification of steps, and are not intended to imply, specify or require a 
particular order of carrying out such steps. 
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